home *** CD-ROM | disk | FTP | other *** search
/ gdead.berkeley.edu / gdead.berkeley.edu.tar / gdead.berkeley.edu / pub / gdead / mac / stack-o-dead-1.8 / stack-o-dead-1.8.2.sit.hqx / README - SOD < prev    next >
Text File  |  1991-03-16  |  11KB  |  284 lines
  1. March 1, 1991
  2.  
  3. Stack-O-Dead
  4. Version 1.8
  5.  
  6. New features of interest in version 1.8...
  7.  
  8. o    All (most) buttons have built in help. Hold down the Command Key when
  9.     clicking on a button to get help. Hold it down for a few seconds after
  10.     the click to be sure.
  11.  
  12. o    Set lists are more accurate as time marches on...
  13.  
  14. o    Each stack has a "= Stacks =" button which has a pop-up menu of stacks so
  15.     you can jump from one to the other easily. Click and hold down until the
  16.     pop-up appears. It takes a few seconds. In general, any button with the
  17.     label enclosed in '==' is a pop-up menu.
  18.  
  19. o    Performance is improved in a number of areas. In particular, the Go To
  20.     operation to go to a show for a given date is much faster now. As more
  21.     and more shows got added to the stacks, this got slower and slower.
  22.  
  23. o   Printing labels... A change in HyperCard 2.0 seems to print things narrower
  24.     than the screen display (and narrower than HC 1.2).  A new button in the 
  25.     Dead Labels stack will switch the labels from the original narrow width to
  26.     a wide width.
  27.  
  28. o    Lots of little fixes and improvements
  29.  
  30. Installation
  31. ------------
  32.  
  33. To run them you need a Macintosh with at least one megabyte, HyperCard 2.0,
  34. and your really should have a hard disk too. The stacks are easily over 
  35. megabytes.
  36.  
  37. After unpacking the stacks from the StuffIt archive, make sure they are all
  38. in one folder.  All you need to do then is open the Dead Utility stack, and you
  39. are on your way.
  40.  
  41. Basic Information
  42. -----------------
  43. 1.    Dead Utility
  44.  
  45.     This is home base. Contains some "one of" cards with user interfaces, some
  46.     artwork, and some sounds. It is pretty big. You can remove some of the
  47.     'snd ' resources if space is a problem, or just move them to another stack.
  48.  
  49. 2.    Dead Shows
  50.  
  51.     A card for each show on record. Started with the '75 thorough '84 lists
  52.     distributed on USENET some time back. Have added 74, 85, 86, 87, and 88.
  53.     The cassette button will send you to a stack of tape records. The tape
  54.     label icon will send you to a labels stack. When you get a new tape, find
  55.     the show, and click the cassette button to create a tape record, and then
  56.     the label button to create the labels from the show card which you may
  57.     need to edit. 
  58.  
  59.     IMPORTANT!!  Whenever you add or delete cards you should sort the stack.
  60.     One thing the sort button does is re-build the internal card map that helps
  61.     Stack-O-Dead quickly find the first card of a given year.  Inserting or
  62.     deleting cards could invalidate the map, so you should do this, even if
  63.     you don't think you changed the sorted order of the stack.
  64.  
  65.     The common features most frequently used are supported on the main card.
  66.     In addition, click on the "Utilities..." button to get an overlay with
  67.     some utility functions, such as Import and Export. There is a button for
  68.     importing set lists which I do as I collect them from usenet. It can
  69.     verify song names in the songs stack, looking for aliases, etc. Use of
  70.     this Validation can be quite slow.    
  71.  
  72. 3.    Dead Tapes
  73.  
  74.     A card for each show you have on tape. Pretty basic. You can copy one of
  75.     these (empty), and use one stack for each person you trade with to keep
  76.     track of trades. There are buttons for importing a text list and for
  77.     exporting your list to a text file for printing.
  78.     
  79.     This stack comes with one blank card.  Once you have created a tape record
  80.     from the Shows Stack, you will have the original empty card, which can be
  81.     deleted.
  82.  
  83. 4.    Dead Labels
  84.  
  85.     A card for each tape. When you create labels from the tape label buttons
  86.     in Shows or Tapes, it will create both set 1 and set 2 labels, filling
  87.     in the songs from the show card.
  88.     
  89.     This stack comes with one blank card.  Once you have created a tape record
  90.     from the Shows stack or the Tapes stack, you will have the original empty
  91.     card, which can be deleted.
  92.  
  93. 5.    Songs
  94.  
  95.     I know, it should be "Dead Songs", but it isn't, and one problem with
  96.     HyperCard is that it is HyperProgramming and script references to the
  97.     stack are everywhere.
  98.  
  99.     This stack contains a card for each song. It has some statistics, which
  100.     are incomplete and not guaranteed, but vastly improved over previous
  101.     versions. It also has the lyrics in most cases, (thanks Allen) and
  102.     provisions for entering/displaying chords with the lyrics for all you
  103.     pickers out there.
  104.  
  105.     As in the Dead Shows stack, the more commonly used functions are
  106.     available on the basic card. Click on the "Utilities..." button to be
  107.     presented with a set of utility functions. To return, click on the
  108.     "Main..." button.
  109.  
  110. 6.    Dead Tunes
  111.  
  112.     This is an optional stack. You had to send me a third disk if you wanted
  113.     it. Everyone does. This stack contains a bunch of dead sound clips, an
  114.     addition to the ones in Dead Utility. Stack-O-Dead lets you specify
  115.     where your songs are played from. You can move these sounds into Dead
  116.     Utility, or the ones from Dead Utility into this stack. There is an
  117.     install button that will copy a 'snd ' resource from this stack (or
  118.     file) to another. Or, if you have the ResCopy 'XCMD', use that.
  119.  
  120. 7.    Dead Stats
  121.  
  122.     This stack has cards for each year with buttons for displaying (or
  123.     re-generating) statistics about songs and shows. To change the display,
  124.     click the button for the list you want to see. To regenerate a list
  125.     (against one of the other stacks), hold down the option key when you
  126.     click. There is also a card for general statistics.
  127.  
  128.  
  129. Show Information
  130. ----------------
  131.  
  132. For those of us with access to UseNet or other bulletin boards, there are
  133. setlists flying around all the time. There is in the Dead Shows stack a
  134. feature for importing text files containing set lists for shows. Click
  135. on the Import... button and you will be given the standard file dialog for
  136. selecting a file to import. You will also be given the opportunity to
  137. validate the shows. This means that each song title is validated for proper
  138. phrasing against the Songs stack titles. If the song is not found as a title,
  139. it will try to find an alternate in the A.K.A field of the Songs cards.
  140. Validation is pretty slow at the moment. I am working on XCMDs that will
  141. use some updatable resources in the Shows stack to make this faster.
  142. In order to use this feature, the text file must be in a particular format.
  143. In fact, much of how set lists are utilized in Stack-O-Dead rely on this
  144. simple format. Syntax is as follows:
  145.  
  146.    show := show_header comments blanklines setlist
  147.    show_header := date whitespace location <newline>
  148.    date:= mm '/' dd '/' yy
  149.    whitespace = <space> | <tab>
  150.    blanklines := blanklines <newline> | <newline> <newline>
  151.    setlist := setlist blanklines set | set
  152.    set := set song | song
  153.    song := <song title> <newline>
  154.    comments := comments comment | comments blanklines | comment
  155.    comment := '=' <text> <newline>
  156.  
  157. In other words, an importable set list for the 10/17/90 show would look
  158. something like:
  159.  
  160. 10/17/90    Gruga Halle, Essen, West Germany
  161. = Bruce Hornsby on Grand Piano
  162.  
  163. Hell in a Bucket
  164. Sugaree
  165. New Minglewood Blues
  166. Ramble on Rose
  167. Me and My Uncle
  168. Maggie's Farm
  169. High Time
  170. Cassidy
  171. Tennessee Jed
  172. Picasso Moon
  173.  
  174. China Cat Sunflower
  175. I Know You Rider
  176. Truckin'
  177. He's Gone
  178. Drums
  179. The Wheel
  180. I Need a Miracle
  181. Turn on Your Love Light
  182.  
  183. Knockin' on Heaven's Door
  184.  
  185.  
  186. In terms of how I look at a show, any show ends when I hit a new text line
  187. which contains a valid date of the format mm/dd/yy in the first word. So
  188. you can have many shows in a single text file to import.
  189.  
  190. Likewise, there is an export function for dumping shows to a text file,
  191. and it uses this same format for output.
  192.  
  193. Sounds
  194. ------
  195.  
  196. You most likely received the Dead Tunes stack, which has most of the
  197. sounds I ship. There are, however, some sounds available in the Dead
  198. Utility stack. One thing you may want to do is move all the sounds to
  199. one stack, either Utility or Tunes. Then set up the Sound Stack field
  200. in the configuration card (1st card of Dead Utility) with the name of
  201. the stack you chose. To move sounds, you can use the tool delivered with
  202. the Dead Tunes stack on the first card to move from that stack to Dead
  203. Utility (or somewhere else if you like), or you can use ResEdit if you
  204. have it and know how to use it. Or, if you have ResCopy for HyperCard you
  205. can use that. If you really need more instructions, you can E-Mail me, or
  206. call or write and I can get you through it.
  207.  
  208. Or you can turn the sound off and forget the whole issue.
  209.  
  210. Files
  211. -----
  212.  
  213. Stack-O-Dead can save things to files. Your tape list, shows, various
  214. lists you generate throughout. A new feature in this release allows you
  215. to specify the Creator ID of the text files you generate. HyperCard
  216. defaults to MACA, the creator ID for MacWrite text files. The Config card
  217. in dead utility comes with a field to specify the type, initialized to MACA.
  218. If you have some other favorite word processor or editor, you can change
  219. this to use that type. I prefer the MPW editor, so I set this field to "MPS ".
  220.  
  221. Miscellaneous
  222. -------------
  223.  
  224. There is a search facility to let you find all the shows where they played
  225. a sequence of songs, like "Scarlet/Touch of Grey/Fire" (name that mystery
  226. tape!!!). There are buttons for computing things like the number of times
  227. they played "Box of Rain" in 1987, and will also list the shows. As you
  228. enter the Long Beach shows, you may be curious as to the last time
  229. Jack-A-Roe was played. There's a button for that too. And this thing is
  230. completely extensible. They are not protected, so you can add all the
  231. features you want, or fix 'em to work to your liking. There may also be some
  232. bugs too. But, what do you want for free?
  233.  
  234. Customize
  235. ---------
  236.  
  237. Be brave!! HyperCard is not that tough to learn. What you have here
  238. contains all the source for the application. You can modify these stacks
  239. to suit your personal needs. If you do, and you come up with any ideas you
  240. would like to feed back into the main product, then send me a description,
  241. or your version of the stack. I listen, and will use ideas I think I can
  242. fit in for general use. The only thing I ask is that you limit distribution
  243. of your customized versions to your close friends, and clearly identify the
  244. changes somewhere in the help and in the about box as modifications to the
  245. standard release.
  246.  
  247. How to Get a Copy
  248. -----------------
  249. If you would like a copy of Stack-O-Dead for HyperCard, send 3 800K disks
  250. to the address below. Please pre-format the disks. This saves me a lot of
  251. time considering the number of these I do. Also, send a SASE, or postage
  252. and return label for the mailer you send your disks to me in. The stacks
  253. are compressed into StuffIt archives. If you do not have StuffIt, or
  254. UnstuffIt, please specify and I will send that too. I will get the stacks
  255. back to you as fast as I can, which is not always "fast", but I try.
  256.  
  257.  
  258. John Gilbert
  259. 19812  226th Ave NE
  260. Woodinville, WA 98072
  261.  
  262. INTERNET:        gilbert@MDI.COM
  263. UUCP:        ...! uunet ! mdisea ! gilbert
  264.  
  265.  
  266. Order form:
  267.  
  268. ===========================================================
  269.           S t a c k - O - D e a d
  270.  
  271.     Name:
  272.  Address:
  273.  
  274.  
  275.  
  276.   E-MAIL: (if applicable)
  277.  
  278.  
  279.   I have Un/Stuffit (circle):   Yes    No
  280.  
  281. ===========================================================
  282.  
  283.  
  284.